Skip to main content

Calculadora BVRD

POST /apicbbvrd​

Descripción: Endpoint utilizado para ejecutar los cálculos bajo escenarios de compra o venta de títulos. Incluye todos los títulos locales permitiendo 5 escenarios de cálculo. Esta consulta puede incluir o excluir los flujos del cálculo según la configuración.

Parámetros:

  • titulo_id - Nemotécnico o código ISIN del título que desea calcular
  • tipo_insumo - r (rendimiento), p (precio) o t (transado). Define el tipo de insumo para el escenario de cálculo
  • tipo_monto - n (nominal) o t (transado). Define el tipo de monto para el escenario de cálculo
  • insumo - Valor del insumo declarado en el campo tipo_insumo
  • monto - Valor del monto declarado en el campo tipo_monto
  • fecha_liquidacion - Fecha de liquidación para ejecutar el cálculo, formato YYYY-MM-DD
  • ytw (opcional) - Booleano para calcular Yield to Worst en títulos callable
  • id_calculo (opcional) - Identificador numérico del cálculo
  • Config:
    • with_flujos - true/false para incluir los flujos en la respuesta
    • carry_efectivo (opcional) - true/false para incluir el cálculo de carry efectivo con amortizaciones
    • round (opcional) - Número de decimales para redondeo (default: 10)

Consulta:

{
  "auth": {
    "usuario": "colocar_usuario",
    "password": "colocar_password"
  },
  "calculo": [
    {
      "titulo_id": "MH22034",
      "tipo_insumo": "r",
      "tipo_monto": "n",
      "insumo": 10,
      "monto": 1000000,
      "fecha_liquidacion": "2023-05-09",
      "ytw": false,
      "id_calculo": 1
    }
  ],
  "config": {
    "with_flujos": true,
    "carry_efectivo": false,
    "round": 10
  }
}

Respuesta:

[
  {
    "titulo_calculo": {
      "nemotecnico": "MH22034",
      "codisin": "DO1005210922",
      "emisor": "Ministerio de Hacienda",
      "moneda": "DOP",
      "nombre_instrumento": "Bonos de Deuda Ley 64-18",
      "nombre_periodo": "Semestral",
      "tipo_tasa": "Tasa Fija",
      "tipo_amortizacion_capital": "No Amortizable",
      "base_liquidacion": "Actual/Actual",
      "formula_calculo": "8-6-2-365-2-366",
      "fecha_liquidacion": 1683604800,
      "fecha_emision": 1654833600,
      "fecha_vencimiento": 2033524800,
      "fecha_emision_str": "2022-06-10",
      "fecha_vencimiento_str": "2034-06-10",
      "fecha_liquidacion_str": "2023-05-09",
      "monto_nominal": 1000000,
      "monto_nominal_100": 1000000,
      "cantidad_titulos": 10,
      "dias_corrido": 150,
      "cupon_corrido": 53424.65753424657,
      "monto_transado": 1251557.8902738802,
      "monto_limpio": 1198133.2327396336,
      "precio_limpio": 119.81332327396336,
      "precio_sucio": 125.15578902738802,
      "valor_nominal_unitario": 100000,
      "rendimiento": 10,
      "cupon": 13,
      "macaulay_duration": 6.313670927258956,
      "modified_duration": 6.013019930722815,
      "dvo1": 601.3019930722814,
      "sherman_ratio": 0.6313670927258956,
      "convexidad": 51.411868205406115,
      "daily_carry": 356.1644,
      "fact_carry": 0.03561644,
      "years_maturity": 11.08829568788501,
      "fecha_prox_pago_cupon": "2023-06-10",
      "monto_interes_prox_pago_cupon": 64821.91780821918,
      "monto_amort_prox_pago_cupon": 0,
      "monto_total_prox_pago_cupon": 64821.91780821918,
      "valor_presente_prox_pago_cupon": 64268.22194126953,
      "amort_pend_prox_pago_cupon": 1,
      "id_calculo": 1
    },
    "flujos_titulo": [
      {
        "fecha_previo": 1670644800,
        "fecha_flujo": 1686369600,
        "fecha_previo_str": "2022-12-10",
        "fecha_flujo_str": "2023-06-10",
        "dias_cupon": 182,
        "dias_al_flujo": 32,
        "factor_flujo": 0.06482191780821918,
        "periodicidad": 2,
        "cant_meses": 6,
        "tasa_amortizacion": 0,
        "tasa_interes": 0.06482191780821918,
        "amortizacion_acumulada": 1,
        "factor_descuento": 0.9914581998547497,
        "monto_amortizacion": 0,
        "monto_interes": 64821.91780821918,
        "monto_flujo": 64821.91780821918,
        "valor_presente": 64268.22194126953,
        "base_dias": 365
      }
    ]
  }
]